StyleRule

Một số xác định cách các thuộc tính của StyleRule áp dụng so với các thuộc tính tương tự trong StyleRules khác.Giá trị ưu tiên cao hơn có ưu tiên hơn giá trị thấp hơn.Ví dụ, nếu một với ưu tiên có một thuộc tính của , nó sẽ có ưu tiên hơn so với một với các thuộc tính thấp hơn.

Một chuỗi xác định các ví dụ mà StyleRule nên ảnh hưởng đến.Nó có thể là một hỗn hợp của các lựa chọn và kết hợp để phù hợp với các tính năng như tên lớp, tên của thực thể và các mối quan hệ về cấu trúc.

Ví dụ, ".Container > ImageLabel.BlueOnHover:Hover" hiệu quả có nghĩa là quy tắc phong cách thay thế mọi ImageLabel là con của một thẻ instance được gắn thẻ với Container ( .Container > ImageLabel ) và được gắn thẻ với BlueOnHover ( .BlueOnHover ) và ở trạng thái Enum.GuiState.Hover ( :Hover ).

Lựa chọn

<th>Mô tả</th>

    <th>Ví dụ</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>[lớp]</code></td>

    <td>Phù hợp với các ví dụ của một <code>Class.GuiObject</code> hoặc <code>Class.UIComponent</code> lớp.</td>

    <td><code>"Khung"</code><code>"Nút hình ảnh"</code><code>"Góc UIC"</code></td>
  </tr>

  <tr>
    <td><code>.[tag]</code></td>

    <td>Phù hợp với các thẻ <a href="/studio/properties#instance-tags">được gắn thẻ</a> với một thẻ <code>Class.CollectionService</code> .</td>

    <td><code>".Container"</code><code>".BlueOnHover"</code></td>
  </tr>

  <tr>
    <td><code>[tên] #name</code></td>

    <td>Phù hợp với các ví dụ của một lớp cụ thể <code>Class.Instance.Name</code>.</td>

    <td><code>#1 #2</code><code>#3 #4</code></td>
  </tr>

  <tr>
    <td><code>[trạng thái]:</code></td>

    <td>Phù hợp với các ví dụ hiện tại trong một <code>Enum.GuiState</code>.</td>

    <td><code>":Lướt"</code></td>
  </tr>
</tbody>

Các kết hợp viên

<th>Mô tả</th>

    <th>Ví dụ</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>></code></td>

    <td>Phù hợp với các ví dụ mà là <b>trẻ em trực tiếp</b> của các trận lọc trước.</td>

    <td width="40%"><code>“Khung > .Inventory”</code></td>
  </tr>

  <tr>
    <td><code>>></code></td>

    <td>Phù hợp với các ví dụ mà là <b>con cháu</b> của các trận lọc trước.</td>

    <td><code>“Nút hình ảnh >> .BlueOnHover”</code></td>
  </tr>

  <tr>
    <td><code>,</code></td>

    <td>Xác định một danh sách các lựa chọn độc lập nhiều cho quy tắc phong cách.</td>

    <td><code>“Frame.TagA, TextLabel.TagA”</code></td>
  </tr>

  <tr>
    <td><code>::</code></td>

    <td>Tạo một ví dụ lớp <code>Class.UIComponent</code> dưới các bộ lọc trước đó và áp dụng các thuộc tính của quy tắc phong cách cho nó.</td>

    <td><code>“Frame::UICorner”</code></td>
  </tr>
</tbody>

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local screenGui = script.Parent

local coreSheet = Instance.new("StyleSheet")
coreSheet.Parent = ReplicatedStorage
local styleLink = Instance.new("StyleLink")
styleLink.StyleSheet = coreSheet
styleLink.Parent = screenGui
local rule = Instance.new("StyleRule")
rule.Parent = coreSheet

-- Class selector
rule.Selector = "TextButton"

-- Set rule properties
rule:SetProperties({
	["BackgroundColor3"] = Color3.fromHex("335FFF"),
	["TextColor3"] = Color3.fromHex("E1E1E1"),
	["Size"] = UDim2.new(0.15, 0, 0, 40),
	["BorderSizePixel"] = 0
})

local button = Instance.new("TextButton")
button.Text = "Main Menu"
button.Parent = screenGui

local CollectionService = game:GetService("CollectionService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local screenGui = script.Parent

local coreSheet = Instance.new("StyleSheet")
coreSheet.Parent = ReplicatedStorage
local styleLink = Instance.new("StyleLink")
styleLink.StyleSheet = coreSheet
styleLink.Parent = screenGui
local rule = Instance.new("StyleRule")
rule.Parent = coreSheet

-- Tag selector
rule.Selector = ".ButtonPrimary"

-- Set rule properties
rule:SetProperties({
	["BackgroundColor3"] = Color3.fromHex("FF0099"),
	["TextColor3"] = Color3.fromHex("E1E1E1"),
	["Size"] = UDim2.new(0.15, 0, 0, 40),
	["BorderSizePixel"] = 0
})

local button = Instance.new("TextButton")
button.Text = "Main Menu"
button.Parent = screenGui
-- Apply tag to button
CollectionService:AddTag(button, "ButtonPrimary")

local CollectionService = game:GetService("CollectionService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local screenGui = script.Parent

local coreSheet = Instance.new("StyleSheet")
coreSheet.Parent = ReplicatedStorage
local styleLink = Instance.new("StyleLink")
styleLink.StyleSheet = coreSheet
styleLink.Parent = screenGui
local rule = Instance.new("StyleRule")
rule.Parent = coreSheet

-- UI component selector
rule.Selector = "Frame.RoundedCorner20::UICorner"

-- Set rule property
rule:SetProperty("CornerRadius", UDim.new(0, 20))

-- Create frame
local frame = Instance.new("Frame")
frame.Size = UDim2.new(0.4, 0, 0.2, 0)
frame.Parent = screenGui
-- Apply tag to frame
CollectionService:AddTag(frame, "RoundedCorner20")

Một chuỗi chỉ đọc hiển thị lỗi từ thuộc tính Selector như lỗi ngữ pháp, loại lớp không được hỗ trợ, v.v.

Trả về một từ điển các cặp chìa khóa-giá trị mô tả các thuộc tính của StyleRule, ví dụ:

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")

-- Nhận tham chiếu đến quy tắc phong cách
local frameRule = coreSheet.Frame

local props = frameRule:GetProperties()
print(props)
--[[
{
	["AnchorPoint"] = 0.5, 0,
	["BackgroundColor3"] = 1, 0, 0.25
}
]]

Lợi Nhuận

Trả giá trị của một thuộc tính cụ thể trong StyleRule .

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")

-- Nhận tham chiếu đến quy tắc phong cách
local frameRule = coreSheet.Frame

local prop = frameRule:GetProperty("AnchorPoint")
print(prop) --> 0.5, 0

Tham Số

Lợi Nhuận

Tương tự như SetProperty() nhưng cho phép bạn tuyên bố và đặt nhiều thuộc tính của StyleRule cùng một lúc. Mỗi nhiệm vụ nên là một thuộc tính hợp lệ của ảnh hưởng GuiObject hoặc UIComponent ( UICorner , UIGradient , v.v.), và mỗi giá trị được gán nên phù hợp với loại giá trị của thuộc tính, ví dụ Vector2 cho AnchorPoint hoặc Color3 cho BackgroundColor3 .

Các nỗ lực để gán tên thuộc tính không hợp lệ như "AnchorPt" hoặc "BkColor" sẽ thất bại lặng lẽ.Loại trùng lặp như CFrame cho AnchorPoint hoặc UDim2 cho BackgroundColor3 sẽ cũng thất bại và một lỗi sẽ xuất hiện trong cửa sổ Thành phẩm.

Để thiết lập/cập nhật chỉ một thuộc tính của một StyleRule , xem SetProperty() .

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")

-- Nhận tham chiếu đến quy tắc phong cách
local frameRule = coreSheet.Frame

-- Đặt tính chất quy tắc
frameRule:SetProperties({
	["AnchorPoint"] = Vector2.new(0.5, 0),
	["BackgroundColor3"] = Color3.new(1, 0, 0.25)
})

Lưu ý rằng bạn có thể gán token như giá trị thuộc tính thông qua tiền tố $:

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local tokensSheet = ReplicatedStorage:FindFirstChild("Tokens")

-- Đặt token (thuộc tính) trên trang token
tokensSheet:SetAttribute("TopCenterAnchor", Vector2.new(0.5, 0))
tokensSheet:SetAttribute("MainBackgroundColor", Color3.new(0.2, 0.2, 0.3))

-- Nhận tham chiếu đến quy tắc phong cách
local frameRule = coreSheet.Frame

-- Đặt tính chất quy tắc
frameRule:SetProperties({
	["AnchorPoint"] = "$TopCenterAnchor",
	["BackgroundColor3"] = "$MainBackgroundColor"
})

Tham Số

Lợi Nhuận

Đặt một thuộc tính mới (hoặc sửa thuộc tính hiện có) cho StyleRule .Tham số name phải là một thuộc tính hợp lệ của ảnh hưởng GuiObject hoặc UIComponent ( UICorner , UIGradient , v.v.), và giá trị được gán phải phù hợp với loại giá trị của thuộc tính, ví dụ Vector2 đối với AnchorPoint hoặc Color3 đối với BackgroundColor3 .

Các nỗ lực để gán tên thuộc tính không hợp lệ như "AnchorPt" hoặc "BkColor" sẽ thất bại lặng lẽ.Loại trùng lặp như CFrame cho AnchorPoint hoặc UDim2 cho BackgroundColor3 sẽ cũng thất bại và một lỗi sẽ xuất hiện trong cửa sổ Thành phẩm.

Để đặt nhiều thuộc tính cho một StyleRule tại một lúc, xem SetProperties() .

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")

-- Nhận tham chiếu đến quy tắc phong cách
local frameRule = coreSheet.Frame

-- Đặt tính chất quy tắc
frameRule:SetProperty("BackgroundColor3", Color3.new(1, 0, 0.25))

Lưu ý rằng bạn có thể gán token như giá trị thuộc tính thông qua tiền tố $:

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local tokensSheet = ReplicatedStorage:FindFirstChild("Tokens")

-- Thiết lập token mới (thuộc tính) trên trang token
tokensSheet:SetAttribute("MainBackgroundColor", Color3.new(0.2, 0.2, 0.3))

-- Nhận tham chiếu đến quy tắc phong cách
local frameRule = coreSheet.Frame
-- Đặt tính chất quy tắc để sử dụng token làm giá trị của nó
frameRule:SetProperty("BackgroundColor3, "$MainBackgroundColor")

Tham Số

Lợi Nhuận