小明用async/await寫了幾年的異步方法，但總沒有完全理解裏面的機制，他決定去請教鄰居小花。

小花聽了小明的描述后說：首先你要明白異步的根本是什麼？大白話解釋異步就是：拉一個人（線程）幫着做一些耗時的事（下載、讀寫數據庫等）,我先做別的事了（退出線程）,等做好了和我說下，我再繼續做後面的事（恢復上下文）。

小花看到小時還沒有明白，就說：我舉個簡單例子幫你理解吧，假如有兩個方法A和B，A調用B方法，B方法是一個異步方法，這時A不等待B執行完，如圖：

現在兩個方法被分隔幾個小塊，await關鍵字其實就用來隔開同步和異步，上面的方法執行流程如下：

A調用B方法后，B方法在未執行到await之前還是同步方法，比如輸出Sub1還是在當前線程中執行，當方法遇到await后，就會把await后的方法放到新的線程中執行，當前線程則退出函數，由於調用的地方並沒有await，則主線程會繼續執行並輸出Part2，然後結束。等新線程中Thread.Sleep(5000)執行完后，會執行到Console.Write(“Sub2”);這一行代碼會回到原來的線程執行，其實遇到await時會捕獲當前線程的執行上下文，然後給到新線程，新線程在執行完耗時操作后，會判斷之前捕獲到的執行上下方是否為null，如果不為null，則會在上下文中恢復並執行後面的方法，其實就是通過Tak的ContineWith方法註冊回調，如圖：

小明好像聽懂了一些說：現在A方法調用DoSomethingAsync()並沒有等待，如果A方法需要這個方法執行完才能繼續執行，是不是要在DoSomethingAsync()前面加上await？小花回答是，並說：方法只要遇到await，就會把後面的方法給新線程執行，然後線程退出去執行別的方法，等新線程執行完后再通知當前線程恢復上下文繼續執行，如圖：

小明又問：你說異步方法執行完后，後面的方法會在原來的線程中恢復並執行，如果我還想在新線程中繼續執行剩下的代碼，要怎麼辦呢？小花說問的好，await調用新線程執行耗時操作時默認會捕獲當前上下文，如果不想捕獲，則可以調用ConfigAwait(false)方法，如圖：

執行流程如下：

小花補充到，上線提到的線程1、線程2、線程3等不一定準確，因為異步的回調是使用線程池中的線程，所以回調有可能還在原來線程中執行，這個主要看操作系統的調度。

小明滿意的點點頭又問：我經常聽同事說用異步方法會死鎖，這又是為什麼呢？小花聽了說，他們肯定是在調用異步方法的時候使用.Result()，如圖：

小花指着圖解釋說：上面的代碼task.Result()會阻塞線程等待task返回結果，DoSomethingAsync方法在執行完Thread.Sleep(5000)后，發現捕獲到的上下文不為空，則會嘗試將Console.Write(“Sub2”)這行代碼交由調用線程去執行，而這時調用線程還在等待，就這樣互相卡着對方，就造成了死鎖，如圖：

小明點了點頭又問：那要怎麼避免呢？小花說出現這種情況也和框架有關，像WinForm為了讓所有UI操作都在主線程中執行，就添加了一個SynchronizationContext類實例用以表示當前上下文，而像控制台等項目這個SynchronizationContext實例默認為null，所以即使使用.Result也不會死鎖。但最好使用異步的時候不要用.Result，可以使用ConfigAwait(false)指明不捕獲上下文，或所有的方法全部異步到底。

 

小明聽完滿意地回到自己的隔間。

 

更多精彩，請關注我的公眾號：

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※帶您來了解什麼是 USB CONNECTOR  ?

※自行創業缺乏曝光? 網頁設計幫您第一時間規劃公司的形象門面

※如何讓商品強力曝光呢? 網頁設計公司幫您建置最吸引人的網站，提高曝光率!

※綠能、環保無空污,成為電動車最新代名詞，目前市場使用率逐漸普及化

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

※教你寫出一流的銷售文案?

概要

索引是我們使用Elasticsearch里最頻繁的部分日常的操作都與索引有關，本篇從運維人員的視角，來玩一玩Elasticsearch的索引操作。

基本操作

在運維童鞋的視角里，索引的日常操作除了CRUD，還是打開關閉、壓縮、alias重置，我們來了解一下。

創建索引

[esuser@elasticsearch02 ~]$curl -XPUT 'http://elasticsearch02:9200/music?pretty' -H 'Content-Type: application/json' -d '
{
    "settings" : {
        "index" : {
            "number_of_shards" : 3, 
            "number_of_replicas" : 2 
        }
    },
    "mappings" : {
        "type1" : {
            "properties" : {
                "name" : { "type" : "text" }
            }
        }
    }
}'

{
    "acknowledged": true,
    "shards_acknowledged": true
}

默認情況下，索引創建命令會在每個primary shard的replica shard 開始進行複製后，或者是請求超時之後，返迴響應消息，如上。

acknowledged表示這個索引是否創建成功，shards_acknowledged表明了每個primary shard有沒有足夠數量的replica開始進行複製。

可能這兩個參數會為false，但是索引依然可以創建成功。因為這些參數僅僅是表明在請求超時之前，這兩個操作有沒有成功，也有可能請求超時了，在超時前都沒成功，但是實際上Elasticsearch Server端接收到了消息，並且都執行了，只是響應前還沒來得及執行，所以響應的是false。

刪除索引

curl -XDELETE 'http://elasticsearch02:9200/music?pretty'

查詢索引設置信息

curl -XGET 'http://elasticsearch02:9200/music?pretty'

打開/關閉索引

curl -XPOST 'http://elasticsearch02:9200/music/_close?pretty'
curl -XPOST 'http://elasticsearch02:9200/music/_open?pretty'

如果一個索引關閉了，那麼這個索引就沒有任何的性能開銷了，只要保留這個索引的元數據即可，然後對這個索引的讀寫操作都不會成功。一個關閉的索引可以接着再打開，打開以後會進行shard recovery過程。

如果集群數據定時有備份，在執行恢復的操作之前，必須將待恢復的索引關閉，否則恢復會報失敗。

壓縮索引

我們知道索引的primary shard數量在創建時一旦指定，後期就不能修改了，但是有一個這樣的情況：預估的shard數量在實際生產之後，發現估算得有點高，比如原來設置number_of_shards為8，結果生產上線后發現數據量沒那麼大，我想把這個索引的primary shard壓縮一下，該如何操作呢？

shrink命令的作用就是對索引進行壓縮的，不過有個限制：壓縮后的shard數量必須可以被原來的shard數量整除。如我們的8個primary shard的index可以只能被壓縮成4個，2個，或者1個primary shard的index。

shrink命令的工作流程：

1. 創建一個跟source index的定義一樣的target index，但是唯一的變化就是primary shard變成了指定的數量。
2. 將source index的segment file直接用hard-link的方式連接到target index的segment file，如果操作系統不支持hard-link，那麼就會將source index的segment file都拷貝到target index的data dir中，會很耗時。如果用hard-link會很快。
3. target index進行shard recovery恢復。

案例演示

1. 我們創建一個number_of_shards為8的索引，名稱為music8

curl -XPUT 'http://elasticsearch02:9200/music8?pretty' -H 'Content-Type: application/json' -d '
{
    "settings" : {
        "index" : {
            "number_of_shards" : 8, 
            "number_of_replicas" : 2 
        }
    },
    "mappings" : {
        "children" : {
            "properties" : {
                "name" : { "type" : "text" }
            }
        }
    }
}'

1. 在索引內灌點數據進去
2. 將索引的shard都移到一個node上去，如node1

curl -XPUT 'http://elasticsearch02:9200/music8/_settings?pretty' -H 'Content-Type: application/json' -d '
{
  "settings": {
    "index.routing.allocation.require._name": "node-1", 
    "index.blocks.write": true 
  }
}'

這個過程叫shard copy relocate，使用

`curl -XGET ‘http://elasticsearch02:9200/_cat/recovery?v’

可以查看該過程的進度。

1. 執行shrink命令，新的索引名稱為music9

curl -XPOST 'http://elasticsearch02:9200/music8/_shrink/music9?pretty' -H 'Content-Type: application/json' -d '
{
  "settings": {
	"index.number_of_shards": 2, 
    "index.number_of_replicas": 1,
    "index.codec": "best_compression" 
  }
}'

執行完成后，可以看到music9的shard數據變化了，並且擁有music8所有的數據。

1. 將別名指向新的music9索引，客戶端訪問無感知。

rollover索引

我們最常見的日誌索引，需要每天創建一個新的帶日期的索引，但客戶端又使用同一個alias進行寫入，此時可以用rollover命令將alias重置到這個新的索引上。

假設log_write別名已經存在，示例命令：

curl -XPOST 'http://elasticsearch02:9200/log_write/_rollover/log-20120122
-H 'Content-Type: application/json' -d '
{
  "conditions": {
    "max_age":   "1d"
  }
}'

用crontab定時每天執行一次，並且將日期部分用shell腳本進行參數化，這樣每天都創建一個帶日期的索引名字，而客戶端那邊一直使用log_write別名作寫入操作，對日誌系統非常實用。

索引mapping管理

索引的mapping管理是非常基礎的操作，我們可以在創建索引時定義mapping信息，也可以在索引創建成功后執行增加字段操作。

列舉以下幾個常用示例：

查看索引的mapping信息

curl -XGET 'http://elasticsearch02:9200/music/_mapping/children?pretty'

查看索引指定field的mapping信息

curl -XGET 'http://elasticsearch02:9200/music/_mapping/children/field/content?pretty'

創建索引時帶上mapping信息

# 節省篇幅，省略大部分字段
curl -XPUT 'http://elasticsearch02:9200/music?pretty' -H 'Content-Type: application/json' -d ' 
{
  "mappings": {
    "children": {
      "properties": {
        "content": {
          "type": "text",
          "fields": {
            "keyword": {
              "type": "keyword",
              "ignore_above": 256
            }
          }
		}
      }
    }
  }
}'

為索引增加一個字段name，類型為text

curl -XPUT 'http://elasticsearch02:9200/music/_mapping/children?pretty' -H 'Content-Type: application/json' -d ' 
{
  "properties": {
    "name": {
      "type": "text"
    }
  }
}'

索引別名

客戶端訪問Elasticsearch的索引時，規範化操作都不會直接使用索引名稱，而是使用索引別名，索引別名能夠起到封裝Elasticsearch真實索引的作用，像上面的rollover操作，索引重建操作，別名起到了非常關鍵的作用。

我們來簡單看一下索引的基本操作：

# 創建索引別名
curl -XPOST 'http://elasticsearch02:9200/_aliases?pretty' -H 'Content-Type: application/json' -d '
{
    "actions" : [
        { "add" : { "index" : "music", "alias" : "music_prd" } }
    ]
}'

# 刪除索引別名
curl -XPOST 'http://elasticsearch02:9200/_aliases?pretty' -H 'Content-Type: application/json' -d '
{
    "actions" : [
        { "remove" : { "index" : "music", "alias" : "music_prd" } }
    ]
}'

# 重命名別名：先刪掉后添加
curl -XPOST 'http://elasticsearch02:9200/_aliases?pretty' -H 'Content-Type: application/json' -d '
{
    "actions" : [
        { "remove" : { "index" : "music", "alias" : "music_prd" } },
        { "add" : { "index" : "music2", "alias" : "music_prd" } }
    ]
}'

# 多個索引綁定一個別名
curl -XPOST 'http://elasticsearch02:9200/_aliases?pretty' -H 'Content-Type: application/json' -d '
{
    "actions" : [
        { "add" : { "indices" : ["music1", "music2"], "alias" : "music_prd" } }
    ]
}'

索引setting修改

查看索引setting信息：

curl -XGET 'http://elasticsearch02:9200/music/_settings?pretty'

修改setting信息：

curl -XPUT 'http://elasticsearch02:9200/music/_settings?pretty' -H 'Content-Type: application/json' -d '
{
    "index" : {
        "number_of_replicas" : 1
    }
}'

setting最常見的修改項就是replicas的數量，其他的參數修改的場景不是特別多。

索引template

假設我們正在設計日誌系統的索引結構，日誌數據量較大，可能每天創建一個新的索引，索引名稱按日期標記，但別名是同一個，這種場景就比較適合使用index template。

我們舉個示例，先創建一個索引模板：

curl -XPUT 'http://elasticsearch02:9200/_template/template_access_log?pretty' -H 'Content-Type: application/json' -d '
{
  "template": "access-log-*",
  "settings": {
    "number_of_shards": 2
  },
  "mappings": {
    "log": {
      "_source": {
        "enabled": false
      },
      "properties": {
        "host_name": {
          "type": "keyword"
        },
		"thread_name": {
          "type": "keyword"
        },
        "created_at": {
          "type": "date",
          "format": "YYYY-MM-dd HH:mm:ss"
        }
      }
    }
  },
  "aliases" : {
      "access-log" : {}
  }
}'

索引名稱符合”access-log-*”將使用該模板，我們創建一個索引：

curl -XPUT 'http://elasticsearch02:9200/access-log-01?pretty'

查看該索引：

curl -XGET 'http://elasticsearch02:9200/access-log-01?pretty'

可以看到如下結構：

[esuser@elasticsearch02 bin]$ curl -XGET 'http://elasticsearch02:9200/access-log-01?pretty'
{
  "access-log-01" : {
    "aliases" : {
      "access-log" : { }
    },
    "mappings" : {
      "log" : {
        "_source" : {
          "enabled" : false
        },
        "properties" : {
          "created_at" : {
            "type" : "date",
            "format" : "YYYY-MM-dd HH:mm:ss"
          },
          "host_name" : {
            "type" : "keyword"
          },
          "thread_name" : {
            "type" : "keyword"
          }
        }
      }
    },
    "settings" : {
      "index" : {
        "creation_date" : "1581373546223",
        "number_of_shards" : "2",
        "number_of_replicas" : "1",
        "uuid" : "N8AHh3wITg-Zh4T6umCS2Q",
        "version" : {
          "created" : "6030199"
        },
        "provided_name" : "access-log-01"
      }
    }
  }
}

說明使用了模板的內容。

當然也有命令可以查看和刪除template:

curl -XGET 'http://elasticsearch02:9200/_template/template_access_log?pretty'

curl -XDELETE 'http://elasticsearch02:9200/_template/template_access_log?pretty'

索引常用查詢

索引操作統計查詢

發生在索引上的所有CRUD操作，Elasticsearch都是會做統計的，而且統計的內容非常翔實，我們可以使用這條命令：

curl -XGET 'http://elasticsearch02:9200/music/_stats?pretty'

內容非常詳細，有好幾百行，從doc的數據和佔用的磁盤字節數，到get、search、merge、translog等底層數據應有盡有。

segment信息查詢

索引下的segment信息，可以使用這條命令進行查詢：

curl -XGET 'http://elasticsearch02:9200/music/_segments?pretty'

內容也同樣挺多，我們摘抄出關鍵的部分做個示例：

"segments" : {
  "_1" : {
    "generation" : 1,
    "num_docs" : 1,
    "deleted_docs" : 0,
    "size_in_bytes" : 7013,
    "memory_in_bytes" : 3823,
    "committed" : true,
    "search" : true,
    "version" : "7.3.1",
    "compound" : true,
    "attributes" : {
      "Lucene50StoredFieldsFormat.mode" : "BEST_SPEED"
    }
  }
}

這個片段表示名稱為_1的segment的信息。詳細如下：

• _1：segment的名稱
• generation：segment的自增長ID
• num_docs：segment中沒有被刪除的document的數量
• deleted_docs：segment中被刪除的document數量
• size_in_bytes：segment佔用的磁盤空間
• memory_in_bytes：segment會將一些數據緩存在內存中，這個數值就是segment佔用的內存的空間大小
• committed：segment是否被sync到磁盤上去了
• search：segment是否可被搜索，如果這個segment已經被sync到磁盤上，但是還沒有進行refresh，值為false
• version：lucene的版本號
• compound：true表示lucene已將這個segment所有的文件都merge成了一個文件

shard存儲信息

查看索引下shard的存儲情況，分佈在哪個node上，這條命令還是挺有用處的:

curl -XGET 'http://elasticsearch02:9200/music/_shard_stores?status=green&pretty'

摘抄了一個片段，3表示shard的id：

"3" : {
  "stores" : [
    {
      "A1s1uus7TpuDSiT4xFLOoQ" : {
        "name" : "node-2",
        "ephemeral_id" : "Q3uoxLeJRnWQrw3E2nOq-Q",
        "transport_address" : "192.168.17.137:9300",
        "attributes" : {
          "ml.machine_memory" : "3954196480",
          "rack" : "r1",
          "xpack.installed" : "true",
          "ml.max_open_jobs" : "20",
          "ml.enabled" : "true"
        }
      },
      "allocation_id" : "o-t-AwGZRrWTflYLP030jA",
      "allocation" : "primary"
    },
    {
      "RGw1IXzZR4CeZh9FUrGHDw" : {
        "name" : "node-1",
        "ephemeral_id" : "B1pv6c4TRuu1vQNvL40iPg",
        "transport_address" : "192.168.17.138:9300",
        "attributes" : {
          "ml.machine_memory" : "3954184192",
          "rack" : "r1",
          "ml.max_open_jobs" : "20",
          "xpack.installed" : "true",
          "ml.enabled" : "true"
        }
      },
      "allocation_id" : "SaXqL8igRUmLAoBBQyQNqw",
      "allocation" : "replica"
    }
  ]
},

補充幾個操作

1. 清空索引緩存

curl -XPOST 'http://elasticsearch02:9200/music/_cache/clear?pretty'

1. 強制flush

強行將os cache里的數據強制fsync到磁盤上去，同時還會清理掉translog中的日誌

curl -XPOST 'http://elasticsearch02:9200/music/_flush?pretty'

1. refresh操作

顯式地刷新索引，讓在自動refresh前的所有操作變成可見

curl -XPOST 'http://elasticsearch02:9200/music/_flush?pretty'

1. force merge

強制合併segment file，可以減小segment的數量
curl -XPOST 'http://elasticsearch02:9200/music/_forcemerge?pretty'

以上4個操作，一般是由Elasticsearch自動去執行，非特殊情況下不需要人工干預。

小結

本篇從運維角度簡單介紹了一下索引的一些日常操作與管理，能夠熟練應用的話，可以提升操縱索引的效率。

專註Java高併發、分佈式架構，更多技術乾貨分享與心得，請關注公眾號：Java架構社區
可以掃左邊二維碼添加好友，邀請你加入Java架構社區微信群共同探討技術

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※帶您來了解什麼是 USB CONNECTOR  ?

※自行創業缺乏曝光? 網頁設計幫您第一時間規劃公司的形象門面

※如何讓商品強力曝光呢? 網頁設計公司幫您建置最吸引人的網站，提高曝光率!

※綠能、環保無空污,成為電動車最新代名詞，目前市場使用率逐漸普及化

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

※教你寫出一流的銷售文案?

　　<svg>是矢量圖的根元素，通過xmlns屬性聲明命名空間，從而告訴用戶代理標記名稱屬於哪個XML方言。在下面的示例中，為<svg>元素聲明了寬度和高度（默認以像素為單位），其子元素<title>可作為提示，在<desc>中可聲明一段描述性純文本，這兩個元素都不會在頁面中呈現。而<rect>是一個矩形，將被繪製到頁面中。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
  <title>SVG example</title>
  <desc>SVG contains a rectangle</desc>
  <rect width="50" height="50" fill="#F60" />
</svg>

　　SVG作為一種圖像格式，可以包含在<img>元素內（如下所示）或CSS樣式中（例如background-image屬性）。

<img src="demo.svg" />

一、坐標系統

1）視口

　　在SVG中，有一張無限大的畫布，而畫布區域被稱為視口（viewport）。通過<svg>元素的width和height兩個屬性可定義視口的尺寸，視口的原點在其左上角。

　　而在視口中，還包含一個坐標系統，由viewBox屬性控制。它能包含四個數值（以逗號或空格分隔），分別是用戶坐標系統的最小橫坐標（x軸）和縱坐標（y軸），以及寬和高。

　　下面的兩個<svg>元素，第一個採用了默認的坐標系統，第二個聲明了新的坐標系統，並且寬高比相同，如圖1所示，第二個矩形縮小了。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" />
</svg>

圖 1

　　接下來修改兩個最小坐標（如圖2所示），第一個<svg>元素聲明的最小坐標為(20,20)，雖然矩形的坐標是(0,0)，但是比最小坐標要小，所以就會往左上角偏移；第二個<svg>元素聲明了負數坐標，與前一個正好相反；在第三個<svg>元素中，修改了矩形的坐標，正好在左上角。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="20 20 300 200">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="-20 -20 300 200">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="20 20 300 200">
  <rect width="50" height="50" fill="#F60" x="20" y="20" />
</svg>

圖 2

2）preserveAspectRatio屬性

　　當viewBox屬性中聲明的尺寸與視圖的寬高比不一致時，可以使用preserveAspectRatio屬性指定圖形的縮放比例和對齊方式，語法如下，默認值是“xMidYMid meet”。

preserveAspectRatio: <align> [<meetOrSlice>]

　　其中<align>的屬性值由兩個軸（x和y）以及三個位置（min、mid和max）組合而成，如表1所列。

表 1

值	說明
xMin	viewport與viewBox的左側對齊
xMid	viewport與viewBox的x軸中點對齊
xMax	viewport與viewBox的右側對齊
YMin	viewport與viewBox的頂部對齊
YMid	viewport與viewBox的y軸中點對齊
YMax	viewport與viewBox的底部對齊

　　在下面的示例中，由於三個<svg>元素寬高比是3:2，而viewBox的寬高比是3:1，因此矩形會等比縮小。對它們分別應用xMinYMin、xMidYMid和xMinYMax，效果如圖3所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 100" preserveAspectRatio="xMinYMin">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 100" preserveAspectRatio="xMidYMid">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 100" preserveAspectRatio="xMinYMax">
  <rect width="50" height="50" fill="#F60" />
</svg>

圖 3

　　注意，因為寬度正好適配，所以對於x軸的對齊方式，效果都是相同的。

　　<meetOrSlice>可控製圖形的適配或裁剪，可選的值如表2所列。

表 2

值	說明
meet	保留圖形的寬高比，並且縮放viewBox以適應viewport
slice	保留圖形的寬高比，並且放大viewBox以覆蓋viewport

　　在下面的示例中，兩個矩形的高度比視口要大，對它們分別應用meet和slice，效果如圖4所示，第二個矩形將整個視口給填滿了。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 100" preserveAspectRatio="xMinYMin meet">
  <rect width="150" height="150" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 100" preserveAspectRatio="xMinYMin slice">
  <rect width="150" height="150" fill="#F60" />
</svg>

圖 4

二、形狀

　　SVG的基本形狀包括線段（line）、矩形（rect）、圓形（circle）、橢圓（ellipse）、多邊形（polygon）和折線（polyline）。

1）<line>

　　線段元素需要指定起止點的坐標，如下所示，效果如圖5所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <line x1="20" y1="100"  x2="100" y2="20" stroke="black" stroke-width="2"/>
</svg>

圖 5

　　其中stroke和stroke-width是筆畫屬性，可指定筆畫的顏色和寬度，相關屬性如表3所列，部分屬性的效果如圖6所示。

表 3

值	說明
stroke	筆畫顏色
stroke-dasharray	筆畫的外觀（實線、點線或虛線），由一系列逗號分隔的数字組成，表示長度和空隙長度
stroke-dashoffset	相對繪圖起點的偏移值
stroke-linecap	描邊的展現形狀
stroke-linejoin	路徑轉角處的形狀
stroke-miterlimit	斜接長度與線寬的最大比例
stroke-opacity	筆畫不透明度，取值範圍0~1，其中0表示透明
stroke-width	筆畫寬度

圖 6

2）<rect>

　　除了直角矩形之外，還可以聲明圓角矩形，如下所示，效果如圖7所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect x="10" y="10" width="100" height="100" rx="15" ry="15" fill="#F60"/>
</svg>

圖 7

3）<circle>和<ellipse>

　　利用圓形，可非常便捷的畫出圓環，效果如圖8所示。將<circle>元素的stroke-dasharray聲明為圓的周長（2πR），例如半徑為50，周長就是314。如果為stroke-dashoffset屬性定義一個值，就能得到圓環缺失一段的效果，從而就能模擬出圓環型的進度條了。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <circle cx="100" cy="100" r="50" stroke="black" stroke-width="2" 
    stroke-dasharray="314" stroke-dashoffset="40" fill="transparent" />
</svg>

圖 8

　　橢圓和圓形類似，只是需要聲明兩個方向的半徑，如圖9所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <ellipse cx="100" cy="100" rx="100" ry="50" />
</svg>

圖 9

4）<polygon>

　　<polygon>可畫出任意形狀的封閉圖形，例如平行四邊形、梯形等。在points屬性中，可聲明各個點的坐標，每組坐標用逗號隔開，下面繪製了一個五角星，如圖10所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <polygon points="100,0 160,180 10,60 190,60 40,180" fill="#F60"/>
</svg>

圖 10

5）<polyline>

　　折線不需要閉合，與<polygon>元素類似，也是由points屬性繪製，如下所示，得到的折線如圖11所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <polyline points="20,100 40,60 70,80 100,20" fill="none" stroke="black" />
</svg>

圖 11

6）<path>

　　上述基本形狀都可以由<path>元素來繪製，並且通過<path>元素還可繪製出不規則的圖形，例如心形，如下所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <path d="M 10,30
           A 20,20 0,0,1 50,30
           A 20,20 0,0,1 90,30
           Q 90,60 50,90
           Q 10,60 10,30 z" />
</svg>

　　其中d屬性可聲明一系列路徑，包含多個指令，如表4所列。

表 4

指令	效果
M、m	移動到指定的坐標
L、l	繪製一條直線
H、h	繪製一條水平線
V、v	繪製一條垂直線
Z、z	關閉路徑
Q、q	繪製一條二次貝塞爾曲線
T、t	繪製一條平滑的二次貝塞爾曲線
C、c	繪製一條三次貝塞爾曲線
S、s	繪製一條平滑的三次貝塞爾曲線
A、a	繪製弧形曲線

三、文檔結構

1）內部樣式

　　SVG允許在其內部嵌入<style>元素，如下所示，其中CDATA區段中的文本會被解析器忽略，但不影響渲染。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <style>
    <![CDATA[
    line {
      stroke: black;
      stroke-width: 2;
    }
    ]]>
  </style>
  <line x1="20" y1="100" x2="100" y2="20" />
</svg>

2）<g>

　　<g>元素相當於一個容器，能將其所有的子元素組合在一起。應用於<g>元素中的屬性會被其子元素所繼承，如下所示，兩個圓的筆畫顏色都是綠色，而寬度都是10，如圖12所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <g id="ring" fill="white" stroke="green" stroke-width="10">
    <circle cx="80" cy="80" r="50" />
    <circle cx="120" cy="120" r="50" />
  </g>
</svg>

圖 12

3）<use>

　　<use>元素可引用其它圖形，以及<g>元素，類似於複製黏貼的功能。在下面的示例中，通過<use>元素的xlink:href屬性引用了id為ring的<g>元素，並且將<use>元素上聲明的屬性傳給了<circle>元素。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <g id="ring">
    <circle cx="80" cy="80" r="50" />
    <circle cx="120" cy="120" r="50" />
  </g>
  <use x="100" y="0" fill="white" stroke="green" stroke-width="10" xlink:href="#ring" />
</svg>

　　注意，當給<use>元素定義坐標后，<circle>元素會與其相加計算出最終的坐標，如圖13所示。

圖 13

4）<defs>

　　可將需要復用的圖形抽象到<defs>元素中，在其內部定義的圖形不會直接呈現到頁面中。在上面那個示例的基礎上，將<g>元素整個放置到<defs>中，效果如圖14所示，沒有渲染<g>元素中的圓。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <defs>
    <g id="ring">
      <circle cx="80" cy="80" r="50" />
      <circle cx="120" cy="120" r="50" />
    </g>
  </defs>
  <use x="100" y="0" fill="white" stroke="green" stroke-width="10" xlink:href="#ring" />
</svg>

圖 14

5）<symbol>

　　<symbol>提供了另一種組合圖形的方式，但與<g>元素不同，它的圖形不會呈現，並且它可以聲明viewBox和preserveAspectRatio兩個屬性，如下所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
  <symbol id="ring" viewBox="0 0 300 200">
    <circle cx="80" cy="80" r="50" />
    <circle cx="120" cy="120" r="50" />
  </symbol>
  <use fill="white" stroke="green" stroke-width="10" xlink:href="#ring" />
</svg>

6）<image>

　　<use>元素可以引用SVG文件的某個部分，而<image>元素可以引用整個SVG文件或柵格圖像（如下所示），並且能控制引用文件的尺寸和preserveAspectRatio屬性，效果如圖15所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <image xlink:href="img/avatar.png" width="150" />
</svg>

圖 15

四、變形、圖案和漸變

1）變形

　　transform屬性定義了一系列圖形元素變形的規則，包括位移（translate）、縮放（scale）、旋轉（rotate）和傾斜（skew）。注意，與CSS3中的transform屬性不同，SVG中的transform屬性作用的對象是坐標系統，而不是元素本身。

　　translate()函數會接收兩個參數，沿x軸和y軸位移坐標系統，如圖16所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" transform="translate(50, 30)" />
</svg>

圖 16

　　scale()函數也會接收兩個參數（這點與CSS3中的scale()不同），沿x軸和y軸縮放坐標系統，如圖17所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" transform="scale(2, 3)" />
</svg>

圖 17

　　rotate()函數可接收三個參數，第一個是旋轉角度，另外兩個是原點坐標，也就是坐標系統按照該原點旋轉，如圖18所示，第三個矩形指定了原點。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" transform="rotate(30)" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" transform="rotate(30, 50, 30)" />
</svg>

圖 18

　　傾斜分為兩個函數：skewX()和skewY()，分別會沿着x軸和y軸傾斜，如圖19所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" transform="skewX(30)" />
</svg>
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100" viewBox="0 0 300 200">
  <rect width="50" height="50" fill="#F60" transform="skewY(30)" />
</svg>

圖 19

2）圖案

　　要創建一個圖案，就得使用<pattern>元素包裹圖形元素，再利用patternUnits屬性確定平鋪圖案的方式。它有兩個關鍵字可選，默認的objectBoundingBox會讓<pattern>元素的尺寸以百分數或0~1之間的小數表示，參照對象分別是引用<pattern>的圖形元素的寬和高。

　　以下面的圖案為例，它的寬和高都是10%，參照的圓形的寬高都是200，計算出的實際值就都是20，效果如圖20所示。

<svg xmlns="http://www.w3.org/2000/svg" width="250" height="200">
  <defs>
    <pattern id="star1" width="10%" height="10%" patternUnits="objectBoundingBox">
      <circle cx="10" cy="10" r="10" />
    </pattern>
  </defs>
  <circle cx="100" cy="100" r="100" fill="url(#star1)" />
</svg>

圖 20

　　另一個userSpaceOnUse會讓<pattern>元素的尺寸以絕對值表示，如下所示，因為<pattern>元素的寬高都為25，所以圖案會有空白間隙，得到的效果如圖21所示。

<svg xmlns="http://www.w3.org/2000/svg" width="250" height="200">
  <defs>
    <pattern id="star2" width="25" height="25" patternUnits="userSpaceOnUse">
      <circle cx="10" cy="10" r="10" />
    </pattern>
  </defs>
  <circle cx="100" cy="100" r="100" fill="url(#star2)" />
</svg>

圖 21

　　<pattern>元素還包含另一個patternContentUnits屬性，用於處理圖案內部的排列方式，它的兩個關鍵字也是objectBoundingBox和userSpaceOnUse，後者是該屬性的默認值。

　　objectBoundingBox會讓<pattern>中的圖形元素以小數定義，如下所示。三個屬性值都是0.1（不能用百分數），參照的仍然是引用<pattern>的圖形元素，計算得到的實際值都是20，效果如圖22所示，每個圖案只显示四分之一個圓。

<svg xmlns="http://www.w3.org/2000/svg" width="250" height="200">
  <defs>
    <pattern id="star3" width="10%" height="10%" patternContentUnits="objectBoundingBox">
      <circle cx=".1" cy=".1" r=".1" />
    </pattern>
  </defs>
  <circle cx="100" cy="100" r="100" fill="url(#star3)" />
</svg>

圖 22

3）漸變

　　<linearGradient>元素用於繪製線性漸變，其子元素<stop>可指定某處的色標（即漸變點），如下所示，在起點、中點和止點處聲明了三種顏色，其中stop-opacity用於聲明不透明度（取值範圍0~1），1表示完全不透明，得到的效果如圖23所示。

<svg xmlns="http://www.w3.org/2000/svg" width="250" height="200">
  <defs>
    <linearGradient id="gradient">
      <stop offset="0" stop-color="#F60" />
      <stop offset="50%" stop-color="#CCC" stop-opacity=".5"/>
      <stop offset="100%" stop-color="#FC0" />
    </linearGradient>
  </defs>
  <rect width="200" height="100" fill="url(#gradient)" />
</svg>

圖 23

　　如果要改變線性漸變的方向，可通過修改起點和終點的坐標實現，例如沿垂直線漸變，代碼如下，得到的效果如圖24所示。

<svg xmlns="http://www.w3.org/2000/svg" width="250" height="200">
  <defs>
    <linearGradient id="gradientVertical" x1="0" y1="0" x2="0" y2="100%">
      <stop offset="0" stop-color="#F60" />
      <stop offset="50%" stop-color="#CCC" stop-opacity=".5" />
      <stop offset="100%" stop-color="#FC0" />
    </linearGradient>
  </defs>
  <rect width="200" height="100" fill="url(#gradientVertical)" />
</svg>

圖 24

　　<linearGradient>元素還有一個spreadMethod屬性，可指定在漸變範圍之外的填充方式，它有三個值可選，如下所列。

　　（1）pad：默認值，用起點和終點的顏色填充。

　　（2）reflect：按終點到起點，起點到終點的方式重複填充。

　　（3）repeat：按起點到終點的方式重複填充。

　　下面用一個示例來演示spreadMethod屬性，如圖25所示，從左往右，spreadMethod屬性的值依次是pad、reflect和repeat。

<svg xmlns="http://www.w3.org/2000/svg" width="800" height="200">
  <defs>
    <linearGradient id="spreadMethod" x1="20%" y1="30%" x2="60%" y2="70%">
      <stop offset="0" stop-color="#F60" />
      <stop offset="40%" stop-color="#CCC" />
      <stop offset="80%" stop-color="#FC0" />
    </linearGradient>
    <linearGradient id="gradientPad" href="#spreadMethod" spreadMethod="pad" />
    <linearGradient id="gradientReflect" href="#spreadMethod" spreadMethod="reflect" />
    <linearGradient id="gradientRepeat" href="#spreadMethod" spreadMethod="repeat" />
  </defs>
  <rect width="200" height="100" fill="url(#gradientPad)" />
  <rect width="200" height="100" fill="url(#gradientReflect)" x="210" />
  <rect width="200" height="100" fill="url(#gradientRepeat)" x="420" />
</svg>

圖 25

　　另外一種徑向漸變由<radialGradient>元素控制，具體可參考官方文檔。

五、文本

1）<text>

　　<text>元素用於處理SVG文件中的文本，在該元素中可修改字體樣式，包括字體名稱、大小、顏色、外觀等。在下面的示例中，聲明了四個<text>元素，併為它們添加了各自的樣式，效果如圖26所示。

<svg xmlns="http://www.w3.org/2000/svg" width="250" height="100">
  <style>
    .small {
      font: italic 13px sans-serif;
    }
    .heavy {
      font: bold 30px sans-serif;
    }
    .Rrrrr {
      font: italic 40px serif;
      fill: red;
    }
  </style>
  <text x="20" y="35" class="small">My</text>
  <text x="40" y="35" class="heavy">name</text>
  <text x="55" y="55" class="small">is</text>
  <text x="65" y="55" class="Rrrrr">Strick!</text>
</svg>

圖 26

2）對齊

　　在<text>元素中對齊文本得用text-anchor屬性，它的對齊方式為起點（start）、居中（middle）和終點（end）。在下面的示例中，為了便於觀察這三個關鍵字的行為，畫了一條參考線，如圖27所示。

<svg xmlns="http://www.w3.org/2000/svg" width="120" height="150">
  <path d="M60,15 L60,110 M30,40 L90,40 M30,75 L90,75 M30,110 L90,110" stroke="grey" />
  <text text-anchor="start" x="60" y="40">Start</text>
  <text text-anchor="middle" x="60" y="75">Middle</text>
  <text text-anchor="end" x="60" y="110">End</text>
</svg>

圖 27

　　SVG中的文本對齊與CSS中的略有不同，當起點對齊時，第一個字符會貼着參考線；當居中對齊時，文本的中間位置會被參考線貫穿；當終點對齊時，文本的最後一個字符會貼着參考線。

3）<tspan>

　　在<text>元素中，通過其子元素<tspan>可調整文本屬性，從而實現一段文本呈現不同的效果，如下所示，這段文本為斜體，而<tspan>元素中的文本被加粗並且賦予了紅色（如圖28所示）。

<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100">
  <style>
    text {
      font: italic 18px serif;
    }
    tspan {
      font: bold 20px sans-serif;
      fill: red;
    }
  </style>
  <text x="10" y="30" class="small">
    My name is
    <tspan>Strick</tspan>!
  </text>
</svg>

圖 28

4）長度
　　textLength屬性用於定義文本的長度，lengthAdjust屬性用於設置字符間距和字形，如下所示，默認值spacing只會控制字符間距，而spacingAndGlyphs還能控制字形，如圖29所示。

<svg xmlns="http://www.w3.org/2000/svg" width="200" height="60">
  <text y="20" textLength="90%" lengthAdjust="spacing">Big text length</text>
  <text y="40" textLength="90%" lengthAdjust="spacingAndGlyphs">Big text length</text>
</svg>

圖 29

5）文本路徑

　　將文本放置在<textPath>元素中，就可讓文本按任意的路徑排列，而不是以往的水平或垂直排列。在下面的示例中，文本按一條螺旋曲線排列，如圖30所示。

<svg xmlns="http://www.w3.org/2000/svg" width="150" height="120">
  <defs>
    <path id="curve" d="M10,90 Q90,90 90,45 Q90,10 50,10 Q10,10 10,40 Q10,70 45,70 Q70,70 75,50" />
  </defs>
  <text>
    <textPath href="#curve">
      My name is Strick! What is your name?
    </textPath>
  </text>
</svg>

圖 30

六、動畫

1）<animate>

　　<animate>是一個動畫元素，它可以包含在圖形元素中，多個<animate>元素可以實現多重動畫。例如將矩形先沿着水平方向，再沿着垂直方向位移，最後在位移結束后切換背景色的動畫，代碼如下所示，效果如圖31。

<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100">
  <rect id="move" width="50" height="50" fill="#F60">
    <animate attributeType="XML" dur="1s" repeatCount="1" attributeName="x"
        from="0" to="50" fill="freeze" begin="1s" id="line" />
    <animate attributeType="XML" dur="1s" repeatCount="1" attributeName="y"
        from="0" to="30" fill="freeze" begin="2s" />
    <animate attributeType="XML" dur="3s" repeatCount="indefinite" attributeName="fill"
        values="#F60;#FC0;#CCC" begin="line.end" />
  </rect>
</svg>

圖 31

　　<animate>元素包含多個動畫屬性，此處只使用了其中的幾個，具體說明如下，其中fill=”freeze”是指動畫結束后保持最後的動作。

　　（1）attributeName：執行動畫的屬性。

　　（2）attributeType：屬性類型，可選值包括XML和CSS。

　　（3）from：屬性的起始值。

　　（4）to：屬性的結束值。

　　（5）dur：動畫持續時間。

　　（6）repeatCount：動畫執行次數，可以是有限次的整數，也可以是無限次的indefinite。

　　（7）begin：動畫開始時機，可以是秒數，也可以是某個動作，例如上面第一個動畫結束后執行顏色的切換。

　　<set>元素是對<animate>元素的補充，可為那些不能過渡的屬性提供動畫，例如在某個時刻显示文本，如下所示，點擊矩形可显示“change color”。

<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100">
  <!--省略矩形代碼-->
  <text x="100" y="20" text-anchor="middle" style="display:none">
    <set attributeName="display" attributeType="CSS" to="block" begin="move.click" dur="1s" fill="freeze" />
    change color
  </text>
</svg>

2）<animateTransform>

　　對於transform屬性的動畫，得用<animateTransform>元素完成。下面的示例演示了旋轉矩形（如圖32所示），其中type屬性用於指定變形的動作，可選的值有translate、scale、rotate、skewX和skewY。

<svg xmlns="http://www.w3.org/2000/svg" width="180" height="160">
  <rect id="move" width="50" height="50" fill="#F60" x="80" y="80">
    <animateTransform attributeName="transform" attributeType="XML" type="rotate"
        from="0 80 80" to="360 80 80" dur="5s" repeatCount="indefinite" />
  </rect>
</svg>

圖 32

3）<animateMotion>

　　<animateMotion>元素可讓圖形沿着任意路徑運動，無論是直線還是曲線，都能實現。在下面的示例中，橙色矩形會沿着S型曲線來回運動，如圖33所示。

<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100">
  <path fill="none" stroke="#000"
        d="M20,50 C20,-50 180,150 180,50 C180-50 20,150 20,50 z" />
  <rect width="20" height="10" fill="#F60">
    <animateMotion dur="10s" repeatCount="indefinite"
        path="M20,50 C20,-50 180,150 180,50 C180-50 20,150 20,50 z" />
  </rect>
</svg>

圖 33

　　如果要讓矩形始終沿着平行於曲線的方向運動，那麼可以將rotate屬性設為auto，如圖34所示。

<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100">
  <path fill="none" stroke="#000"
        d="M20,50 C20,-50 180,150 180,50 C180-50 20,150 20,50 z" />
  <rect width="20" height="10" fill="#F60">
    <animateMotion dur="10s" repeatCount="indefinite" rotate="auto"
        path="M20,50 C20,-50 180,150 180,50 C180-50 20,150 20,50 z" />
  </rect>
</svg>

圖 34

 

【參考資料】
SVG元素參考

[技術分享] 理解 SVG 中的 Viewport 和 ViewBox－拖曳與縮放功能實做（上）

理解SVG viewport,viewBox,preserveAspectRatio縮放

SVG圖像的viewport和viewBox用於設置圖像可見區域的大小

SVG：理解stroke-dasharray和stroke-dashoffset屬性

SVG 研究之路 (16) – Stroke-miterlimit

如何使用SVG圖案

SVG 研究之路 (26) – 有趣的 Patterns

 

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※帶您來了解什麼是 USB CONNECTOR  ?

※自行創業缺乏曝光? 網頁設計幫您第一時間規劃公司的形象門面

※如何讓商品強力曝光呢? 網頁設計公司幫您建置最吸引人的網站，提高曝光率!

※綠能、環保無空污,成為電動車最新代名詞，目前市場使用率逐漸普及化

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

※教你寫出一流的銷售文案?