函数参考

内置辅助函数

游戏内“函数”标签页中列为内置的辅助函数。公共辅助函数直接按名称调用；其他辅助函数需绑定为依赖项（选择自动补全项，或在“依赖项”中添加），再按其完整限定名调用。

240 个辅助函数中的 82 个。清除筛选

`Conditions.bossmod.encounterNote` 依赖项	Builds the status line the boss-mod condition editors show about the current encounter.
`Conditions.bossmod.idEditor` 依赖项	Builds a full-width edit box for an optional boss-mod ID (such as the encounter ID) and adds it to parent.
`Conditions.bossmod.note` 依赖项	Adds a full-width text label to a boss-mod condition editor; used for the encounter and timer status lines.
`Conditions.bossmod.timerNote` 依赖项	Builds the status line the boss-mod condition editors show about running boss-mod timers.
`Conditions.bossmod.validCompare` 依赖项	Validation check for a boss-mod condition's comparison: true when value.operator is one of addon.operators and value.value is a finite number of zero or more.
`Conditions.bossmod.validID` 依赖项	True when value is a positive whole number below 2^31, the accepted shape of a saved boss-mod encounter or spell ID.
`Conditions.build.imbueObservation` 依赖项	Reads the temporary enchant ID on the main hand, or the off hand when value.offhand is set, for the WEAPON_IMBUE condition.
`Conditions.build.setLabel` 依赖项	Formats an item set ID for the SET_PIECES description: the set name with its ID when addon:GetItemSetName knows it, otherwise "item set N".
`Conditions.build.wholeNumber` 依赖项	True when value is a positive, finite whole number; SET_PIECES uses it to validate the saved item set ID.
`Conditions.common.Widget_GetSpellId` 公共	解析条件中存储的法术标识符。启用精确等级时会保留所提供的 ID；否则在有等级的经典版客户端上，会通过法术目录解析当前已知的等级。无法完成解析时返回 nil 和可用性原因。
`Conditions.common.Widget_SpellWidget` 公共	为自定义条件控件创建一个带有建议、验证和法术链接支持的法术输入框。更新回调负责保存所选的值；将返回的控件添加到回调的父级。
`Conditions.common.Widget_UnitWidget` 公共	创建一个绑定到条件值记录的已配置单位选择器。返回该控件，由调用方将其添加到条件回调的父级。
`Conditions.edition_state.eclipseMeasures` 依赖项	Lists the two measures of the Eclipse condition with their editor labels.
`Conditions.edition_state.validCompare` 依赖项	Checks that a condition value carries a known comparison operator and a finite, non-negative number to compare against.
`Conditions.encounter_state.validCompare` 依赖项	Checks that a condition value carries a known comparison operator and a finite, non-negative number to compare against.
`Conditions.encounter_state.validNumber` 依赖项	Checks that a value is a finite number of zero or more (not NaN, not infinite).
`Conditions.engraving.identifier` 依赖项	True when value is a positive whole number below 2^31; RUNE_ENGRAVED uses it to validate a saved rune ID.
`Conditions.engraving.runeLabel` 依赖项	Names the rune selected in a RUNE_ENGRAVED condition: the known rune's name when the platform finds it, else the rune spell's name, else "rune spell N" or "rune N".
`Conditions.equipment.matches` 依赖项	Tests one equipment slot record against a WEAPON_TYPE condition: empty slot, shield, any weapon, holdable, one-hand, two-hand, ranged, or a specific weapon subclass.
`Conditions.equipment.subclassID` 依赖项	True when value is a whole number from 0 to 31, the range of weapon subclass IDs WEAPON_TYPE accepts.
`Conditions.equipment.subclassName` 依赖项	Names a weapon subclass for WEAPON_TYPE descriptions, using the client's GetItemSubClassInfo when it returns a readable name, else the addon's built-in name, else "weapon type N".
`Conditions.group_state.measureNames` 依赖项	Lists what the Group Count condition can count, with the editor label of each.
`Conditions.group_state.validCompare` 依赖项	Checks that a Group Count value carries a known operator and a finite, non-negative number, which is at most 100 when the count is a percent of the group.
`Conditions.hero_talent.listedSpec` 依赖项	Returns the specialization ID when it is one of the player's own class's specializations, which are the only ones whose hero talent trees the game can list.
`Conditions.hero_talent.treeName` 依赖项	Names a hero talent tree: the game's own name for it when Platform:GetHeroTreeName can read one, else "hero talent tree" followed by the ID.
`Conditions.hero_talent.validTree` 依赖项	Checks that a value can be a hero talent tree ID: a positive whole number below 2^31.
`Conditions.item.get_item_desc` 依赖项	Describes an item reference for the item condition descriptions: an item set name (white for a profile set, cyan for a global one), or the first item's link or name followed by how many others are listed.
`Conditions.item.itemHelp` 依赖项	Adds the item condition editors' help text to frame: the shared item widget help, a gap, and a note on how item sets, bag counts and restricted observations are evaluated.
`Conditions.known_spell.validID` 依赖项	True when value is a positive, finite whole number; SPELL_KNOWN uses it to validate the saved spell ID.
`Conditions.misc.difficultyKind` 依赖项	Names the kind of group a difficulty is for, from the group GetDifficultyInfo reports.
`Conditions.misc.difficultyName` 依赖项	The display name of an instance difficulty ID: the game's name for it (GetDifficultyInfo) with the kind of group in parentheses when the game gives one.
`Conditions.misc.validWhole` 依赖项	Checks that a value can be a difficulty or instance ID: a whole number from 0 up to 2^31.
`Conditions.player_state.stateNames` 依赖项	Lists the states the Player State condition offers, with the editor label of each.
`Conditions.player_state.statePhrase` 依赖项	The readable sentence for one Player State, such as "you are mounted", worded so a Not flips it to "you are not mounted".
`Conditions.raid_marks.markListText` 依赖项	Formats a valid list of markers in priority order.
`Conditions.raid_marks.markName` 依赖项	Returns the game's localized name for a raid marker, falling back to its English name.
`Conditions.raid_marks.modeNames` 依赖项	Returns the localized labels for the any, none and selected-mark modes.
`Conditions.raid_marks.validMark` 依赖项	Checks a saved marker mode or a comma-separated list of distinct marker names.
`Conditions.spatial_stats.aggregate` 依赖项	Reduces the per-unit readings a PROXIMITY_* condition collected to one statistic: their average, minimum or maximum.
`Conditions.spatial_stats.observation` 依赖项	Reads one health or mana number for a PROXIMITY_* condition through the evaluation cache, protected against errors.
`Conditions.spatial_stats.statistic` 依赖项	Reads one unit's health or mana for the PROXIMITY_* conditions as an absolute value, a percentage of the maximum, or the deficit below the maximum.
`Conditions.spatial.booleanRead` 依赖项	Calls a yes/no game API through the evaluation cache, protected against errors, for the distance conditions.
`Conditions.spatial.combatFilter` 依赖项	Applies the In Combat option of Distance Count to one unit: with the option off every unit passes, with it on the unit must be in combat (UnitAffectingCombat).
`Conditions.spatial.finite` 依赖项	True when value is a number that is neither NaN nor infinite.
`Conditions.spatial.nameplateDistanceCount` 依赖项	Counts units for DISTANCE_COUNT from a nameplate unit snapshot: units that exist, whose hostility matches value.enemy, and that are definitely within value.distance yards.
`Conditions.spatial.protectedRead` 依赖项	来自 Conditions/spatial.lua 的内置辅助函数。
`Conditions.spatial.rangeMember` 依赖项	Decides whether unit is within distance yards from the platform's cached range-check bounds: true when the maximum bound is at or inside distance, false when the minimum bound is beyond it (or equals a nonzero distance), otherwise unavailable.
`Conditions.spatial.rcf` 依赖项	Returns the LibRangeCheck-3.0 range estimate for a unit as minimum and maximum yards.
`Conditions.specialization.classChoices` 依赖项	Builds the specialization choices for one class in the SPECIALIZATION editor.
`Conditions.specialization.playerClass` 依赖项	Returns the player's class file token (such as "MAGE") from UnitClass, or nil when the call fails or the value is restricted.
`Conditions.specialization.specClass` 依赖项	Looks up which class a specialization ID belongs to, from the built-in specialization table or else the platform's specialization display data.
`Conditions.specialization.specID` 依赖项	True when value is a positive, finite whole number, the accepted shape of a saved specialization ID.
`Conditions.specialization.specName` 依赖项	Names a specialization for SPECIALIZATION descriptions: the platform's display name and icon, else the built-in localized name, else "specialization N".
`Conditions.talent.block` 依赖项	Adds a full-width group laid out as icon rows (the icon on the left, the picker rows beside it) to a condition widget.
`Conditions.talent.classSpecs` 依赖项	Lists the specializations of the player's class for the Talent condition's Specialization picker, so a rotation can pick the talents of a specialization other than the one being played.
`Conditions.talent.dropdown` 依赖项	Creates a full-width condition dropdown labeled title for the talent condition editors, forwards each selection to changed, and adds it to parent.
`Conditions.talent.gridWidget` 依赖项	Builds the TALENT editor controls for the tier-and-column grid talent layout: a talent icon and a dropdown of the client's grid talents (up to 18).
`Conditions.talent.group` 依赖项	Returns the talent group to query for spec: spec itself on progression clients when it is a whole number from 1 to 4, otherwise nil so the platform uses its default group.
`Conditions.talent.groupLabel` 依赖项	The heading above one group of talents in the Retail and Forever talent list: class talents, specialization talents, both, one hero tree, or a plain name.
`Conditions.talent.icon` 依赖项	Creates the 44-pixel talent icon for the TALENT editors, showing the referenced talent's icon and, on hover, its spell tooltip (or its name), and adds it to parent.
`Conditions.talent.info` 依赖项	Looks up the talent a TALENT condition refers to, according to its layout: a trait node and entry, a grid index, or a tree and talent index.
`Conditions.talent.integer` 依赖项	True when value is a whole number between minimum and maximum, inclusive.
`Conditions.talent.legacySlot` 依赖项	True when a TALENT condition still uses the historical single-number layout: no layout, tree or talent field, and value.value a whole number from 1 to 21.
`Conditions.talent.ownTrees` 依赖项	Whether the talent trees shown are the player's own class's, so the game can name them, rather than another class's trees from the addon's shipped list.
`Conditions.talent.text` 依赖项	Adds a full-width explanatory label to a talent condition editor.
`Conditions.talent.traitFamily` 依赖项	True when the client uses trait talents, that is the retail or forever client families.
`Conditions.talent.traitShape` 依赖项	True when value.layout is "traits", meaning the TALENT condition names a trait node.
`Conditions.talent.traitsWidget` 依赖项	Builds the TALENT editor controls for trait talents: a talent tree dropdown when there are several, a talent dropdown, Talent Node ID and Choice Entry ID edit boxes, and a Rank comparison.
`Conditions.talent.treeExists` 依赖项	Checks that a talent condition's tree index exists on this client, using the cached platform talent tree count.
`Conditions.talent.treeName` 依赖项	Names the talent tree in a talent tree condition's description: the client's tree name, else "Talent tree N", else "<talent tree>" when no tree is set.
`Conditions.talent.treePicker` 依赖项	Builds the Talent tree dropdown for the TALENT_TREE_POINTS and PRIMARY_TALENT_TREE editors, listing the client's talent trees, storing the selection in value.tree and calling update.
`Conditions.talent.treeShape` 依赖项	True when a TALENT condition uses the tree layout (layout nil or "tree") with both tree and talent set.
`Conditions.talent.treeWidget` 依赖项	Builds the TALENT editor controls for Classic talent trees: a tree dropdown, a talent icon, a talent dropdown for the chosen tree, and a Points comparison.
`Conditions.totem.amount` 依赖项	True when a totem condition's comparison is usable: value.value is a nonnegative finite number and value.operator is one of addon.operators.
`Conditions.totem.element` 依赖项	True when value.spell is a valid spell ID of 4 or less, meaning the condition names a totem element slot rather than a totem spell.
`Conditions.totem.findSpecific` 依赖项	Searches the totem slots for an active totem matching value.spell, by spell ID or name (only the exact spell ID when value.ranked is set).
`Conditions.totem.observe` 依赖项	Calls a totem platform method through the evaluation cache, passing the platform as its self argument.
`Conditions.totem.remaining` 依赖项	Seconds left on a totem slot record at time start (or now): zero when the totem is inactive, and never negative.
`Conditions.totem.specific` 依赖项	True when a totem spell condition names a valid spell ID and value.ranked is nil or a boolean.
`Conditions.weapon.enchantObservation` 依赖项	Reads whether the main hand, or the off hand when value.offhand is set, has a temporary weapon enchant for the weapon conditions, with its expiration and charges.
`Conditions.weapon.numericObservation` 依赖项	Accepts a readable, nonnegative, finite number from a weapon observation and returns it unchanged; anything else becomes nil with a reason.
`Conditions.weapon.swingSpeed` 依赖项	Reads the player's main-hand, or off-hand when value.offhand is set, attack speed from the cached UnitAttackSpeed for the swing timer conditions.