SVGMaskElement: maskContentUnits property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Thuộc tính chỉ đọc maskContentUnits của giao diện SVGMaskElement phản ánh thuộc tính maskContentUnits. Nó cho biết hệ tọa độ nào sẽ được sử dụng cho nội dung của phần tử <mask>.
Giá trị
Một SVGAnimatedEnumeration đại diện cho hệ tọa độ. Các giá trị khả dụng được định nghĩa trong giao diện SVGUnitTypes:
0(SVG_UNIT_TYPE_UNKNOWN)-
Kiểu không phải là một trong các kiểu được định nghĩa sẵn.
1(SVG_UNIT_TYPE_USERSPACEONUSE)-
Tương ứng với giá trị
userSpaceOnUsecho thuộc tínhmaskContentUnits, nghĩa là tất cả tọa độ bên trong phần tử đều tham chiếu đến hệ tọa độ người dùng được xác định khi mặt nạ được tạo. Đây là giá trị mặc định. 2(SVG_UNIT_TYPE_OBJECTBOUNDINGBOX)-
Tương ứng với giá trị
objectBoundingBoxcho thuộc tính, nghĩa là tất cả tọa độ bên trong phần tử đều tương đối so với hộp giới hạn của phần tử mà mặt nạ được áp dụng. Điều này có nghĩa là gốc của hệ tọa độ là góc trên bên trái của hộp giới hạn đối tượng, và chiều rộng cùng chiều cao của hộp giới hạn đối tượng được coi là có độ dài là 1 đơn vị.
Ví dụ
<div>
<svg
viewBox="0 0 100 100"
width="150"
height="150"
xmlns="http://www.w3.org/2000/svg">
<mask id="mask1" maskContentUnits="userSpaceOnUse">
<rect fill="black" x="0" y="0" width="100%" height="100%" />
<circle fill="white" cx="50" cy="50" r="35" />
</mask>
<mask id="mask2" maskContentUnits="objectBoundingBox">
<rect fill="black" x="0" y="0" width="100%" height="100%" />
<circle fill="white" cx=".5" cy=".5" r=".35" />
<animate
attributeName="maskContentUnits"
values="objectBoundingBox;userSpaceOnUse"
dur="1s"
repeatCount="indefinite" />
</mask>
<!-- Một số hình chữ nhật tham chiếu để thể hiện mặt nạ -->
<rect id="r1" x="0" y="0" width="45" height="45" />
<rect id="r2" x="0" y="55" width="45" height="45" />
<rect id="r3" x="55" y="55" width="45" height="45" />
<rect id="r4" x="55" y="0" width="45" height="45" />
<!-- Ba hình chữ nhật đầu được che với useSpaceOnUse -->
<use mask="url(#mask1)" href="#r1" fill="blue" />
<use mask="url(#mask1)" href="#r2" fill="yellow" />
<use mask="url(#mask1)" href="#r3" fill="green" />
<!-- Hình chữ nhật cuối được che với objectBoundingBox -->
<use mask="url(#mask2)" href="#r4" fill="lightblue" />
</svg>
</div>
<pre id="log"></pre>
const unitType = ["unknown", "userSpaceOnUse", "objectBoundingBox"];
const mask = document.getElementById("mask2");
const log = document.getElementById("log");
function displayLog() {
const baseValue = unitType[mask.maskContentUnits.baseVal];
const animValue = unitType[mask.maskContentUnits.animVal];
log.textContent = `The top-right 'maskContentUnits.baseVal' coord system : ${baseValue}\n`;
log.textContent += `The top-right 'maskContentUnits.animVal' coord system : ${animValue}`;
requestAnimationFrame(displayLog);
}
displayLog();
Thông số kỹ thuật
| Specification |
|---|
| CSS Masking Module Level 1 # dom-svgmaskelement-maskcontentunits |