Spec-Zone.ru › Ruby on Rails 7.2

класс ActiveModel::Name

Родитель:
Объект
Включенные модули:

Атрибуты

cache_key[RW]
collection[RW]
element[RW]
i18n_key[RW]
name[RW]
param_key[RW]
plural[RW]
route_key[RW]
singular[RW]
singular_route_key[RW]

Публичные Классовые Методы

new(klass, namespace = nil, name = nil, locale = :en) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 166
def initialize(klass, namespace = nil, name = nil, locale = :en)
  @name = name || klass.name

  raise ArgumentError, "Class name cannot be blank. You need to supply a name argument when anonymous class given" if @name.blank?

  @unnamespaced = @name.delete_prefix("#{namespace.name}::") if namespace
  @klass        = klass
  @singular     = _singularize(@name)
  @plural       = ActiveSupport::Inflector.pluralize(@singular, locale)
  @uncountable  = @plural == @singular
  @element      = ActiveSupport::Inflector.underscore(ActiveSupport::Inflector.demodulize(@name))
  @human        = ActiveSupport::Inflector.humanize(@element)
  @collection   = ActiveSupport::Inflector.tableize(@name)
  @param_key    = (namespace ? _singularize(@unnamespaced) : @singular)
  @i18n_key     = @name.underscore.to_sym

  @route_key          = (namespace ? ActiveSupport::Inflector.pluralize(@param_key, locale) : @plural.dup)
  @singular_route_key = ActiveSupport::Inflector.singularize(@route_key, locale)
  @route_key << "_index" if @uncountable
end

Возвращает новый экземпляр ActiveModel::Name. По умолчанию, опция namespace и опция name будут принимать соответственно пространство имен и имя данного класса. Используйте аргумент locale для получения единственного и множественного числа имени модели.

module Foo
  class Bar
  end
end

ActiveModel::Name.new(Foo::Bar).to_s
# => "Foo::Bar"

Публичные Методы Экземпляров

!~(regexp) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 83
    

Эквивалентно String#!~. Сопоставляет имя класса с заданным regexp. Возвращает true если совпадения нет, иначе false.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name !~ /Post/ # => false
BlogPost.model_name !~ /\d/   # => true
<→(other) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 50
    

Эквивалентно String#<=>.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name <=> 'BlogPost'  # => 0
BlogPost.model_name <=> 'Blog'      # => 1
BlogPost.model_name <=> 'BlogPosts' # => -1
==(other) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 19
    

Эквивалентно String#==. Возвращает true если имя класса и other равны, иначе false.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name == 'BlogPost'  # => true
BlogPost.model_name == 'Blog Post' # => false
===(other) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 35
    

Эквивалентно #==.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name === 'BlogPost'  # => true
BlogPost.model_name === 'Blog Post' # => false
=~(regexp) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 66
    

Эквивалентно String#=~. Сопоставляет имя класса с заданным regexp. Возвращает позицию начала совпадения или nil если совпадения нет.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name =~ /Post/ # => 4
BlogPost.model_name =~ /\d/   # => nil
eql?(other) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 99
    

Эквивалентно String#eql?. Возвращает true если имя класса и other имеют одинаковую длину и содержимое, иначе false.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name.eql?('BlogPost')  # => true
BlogPost.model_name.eql?('Blog Post') # => false
human(options = {}) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 197
def human(options = {})
  return @human if i18n_keys.empty? || i18n_scope.empty?

  key, *defaults = i18n_keys
  defaults << options[:default] if options[:default]
  defaults << MISSING_TRANSLATION

  translation = I18n.translate(key, scope: i18n_scope, count: 1, **options, default: defaults)
  translation = @human if translation == MISSING_TRANSLATION
  translation
end

Преобразует имя модели в более удобочитаемый формат, используя I18n. По умолчанию, он преобразует имя класса в нижний регистр, добавляет символ подчеркивания, а затем делает его удобочитаемым.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name.human # => "Blog post"

Укажите options с дополнительными опциями перевода.

match?(regexp) Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 115
    

Эквивалентно String#match?. Сопоставляет имя класса с заданным regexp. Возвращает true если совпадение есть, иначе false.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name.match?(/Post/) # => true
BlogPost.model_name.match?(/\d/) # => false
to_s() Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 131
    

Возвращает имя класса.

class BlogPost
  extend ActiveModel::Naming
end

BlogPost.model_name.to_s # => "BlogPost"
to_str() Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 151
delegate :==, :===, :<=>, :=~, :"!~", :eql?, :match?, :to_s,
         :to_str, :as_json, to: :name

Эквивалентно to_s.

uncountable?() Показать исходный код
# File activemodel/lib/active_model/naming.rb, line 209
def uncountable?
  @uncountable
end

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API